home *** CD-ROM | disk | FTP | other *** search
/ Micro R&D 1 / MicroRD-CD-ROM-Vol1-1994.iso / os20 / cli / setwin1_0.lha / SetWin 1.0 / SetWin.doc < prev    next >
Text File  |  1993-12-01  |  6KB  |  179 lines
  1.  
  2.                   ____       _ __        ___          _   ___  
  3.                  / ___|  ___| |\ \      / (_)_ __    / | / _ \ 
  4.                  \___ \ / _ \ __\ \ /\ / /| | '_ \   | || | | |
  5.                   ___) |  __/ |_ \ V  V / | | | | |  | || |_| |
  6.                  |____/ \___|\__| \_/\_/  |_|_| |_|  |_(_)___/ 
  7.  
  8.                             © 1993 by Frank Würkner
  9.                               All Rights Reserved
  10.  
  11.  
  12.  
  13. COPYRIGHT NOTE
  14. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  15. The program SetWin is copyrighted © 1993 by Frank Würkner.
  16. All rights reserved.
  17.  
  18. SetWin is FREEWARE.  This program may be freely distributed as long as
  19.   - the executable and documentation remain unchanged and
  20.     are included in the distribution
  21.   - No other charge is made than to cover time and copying costs
  22.  
  23.  
  24. DISCLAIMER
  25. ¯¯¯¯¯¯¯¯¯¯
  26. No warranties of any kind are made as to the functionality of this
  27. program. You are using it ENTIRE at your own risk.
  28.  
  29.  
  30. SYSTEM REQUIREMENTS
  31. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  32. To run SetWin you'll need OS2.0 or higher !!!
  33.  
  34.  
  35. QUICK OVERVIEW
  36. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  37. SetWin let's you manipulate nearly everything of a window. You can change
  38. the size, position, window limits, the zipped size and titles (window and
  39. screen). Of course you can also cause actions on the window such as to
  40. activate, zip, bring it in front/back, center and close/kill it.
  41. You also have the ability to get information about any window.
  42.  
  43.  
  44. USAGE
  45. ¯¯¯¯¯
  46. SetWin only works in your CLI, so don't start it from your Workbench !
  47. Nearby SetWin is pure and can be made resident.
  48. It has the following template :
  49.      WINDOW/A,VERBOSE=VERB/S,SHOW/S,ALL/S,WBWIN/S,ACTIVATE/S,
  50.      ZIP/S,FRONT/S,BACK/S,CENTER/S,CLOSE/S,KILL/S,SCREENNAME=SN/K,
  51.      WIN/K,ZIPWIN/K,LIMIT/K,WTITLE/K,STITLE/K
  52.  
  53. WINDOW/A
  54.      This specifies the window(s) that should be affected. There are five
  55.      possible ways to do so :
  56.      - By pattern (any standard AmigaDOS wildcard is supported). Your
  57.        pattern is compared with each windowtitle of the screen,
  58.        e.g. *any_title_segment*
  59.      - The hexadecimal address of a window, must start with a "$",
  60.        e.g. $0034DD50
  61.      - Keyword "NOW". The window where the command is launched from.
  62.      - Keyword "ACTIVE". The active window.
  63.      - Keyword "CLICK". The programm waits for you to click with the left
  64.        mouse-button (at least ¼ second) over a window.
  65.  
  66. VERBOSE=VERB/S (this only makes sence if your window is a pattern)
  67.      This will also promt any window (title and address) that doesn't
  68.      match your pattern. Use this switch if you get a "No such windowtitle."
  69.      error. Sometimes the text visible in the Title is not the real
  70.      windowtitle.
  71.  
  72. SHOW/S
  73.      Displays information about the window in the following form
  74.      1: Window "<Windowtitle>" at address $<Headecimal address of window>
  75.      2: WIN=<X position of window>/<Y position>/<X-Size>/<Y-Size>
  76.         (actual size <X-Size without border>x<Y-Size without border>,
  77.         <chars per line>x<lines> chars, <X-Fontsize>x<Y-Fontsize> font)
  78.      3: ZIPWIN=<X position of zipped window>/<Y position>/<X-Size>/<Y-Size>
  79.      4: LIMIT=<min. X-Size>/<max. Y-Size>/<min. X-Size>/<max. X-Size>
  80.      5: WindowFlagSet{<flags describing the look of the window>}
  81.      6: IDCMPFlagSet{<flags describing what the window is waiting for>}
  82.  
  83. ALL/S (this only makes sence if your window is a pattern)
  84.      Means that you want affect all windows matching your pattern, not
  85.      only the first found, e.g. "*" would match all windows that have
  86.      a title.
  87.  
  88. WBWIN/S
  89.      The window must have the wbenchWindow-flag switched on in the
  90.      WindowFlagSet. These are normally the windows opened by Workbench.
  91.  
  92. ACTIVATE/S
  93.      Activate the window (same as if you click in).
  94.  
  95. ZIP/S
  96.      Zip the window (same as if you click the zipgadget).
  97.  
  98. FRONT/S
  99.      Bring the window in front of all other windows.
  100.  
  101. BACK/S
  102.      Bring the window behind all other windows.
  103.  
  104. CENTER/S
  105.      Center the window relativ to the screen.
  106.  
  107. CLOSE/S
  108.      Tell the programm which owns the window to close it
  109.      (same as if you click the closegadget).
  110.  
  111. KILL/S
  112.      Call CloseWindow() from intuition.
  113.      WARNIG :
  114.      You shouldn't use this switch if you are a learner.
  115.      You must be _ABSOLUTELY_ sure that the corresponding task doesn't
  116.      use the window anymore.
  117.  
  118. SCREENNAME=SN/K
  119.      Normally only windows of the active screen are affected, with
  120.      this switch you can use an other screen. Of course any standard
  121.      AmigaDOS wildcard is supported.
  122.  
  123. WIN/K
  124.      This option must be oft the form :
  125.      "WIN=<X position of window>/<Y position>/<X-Size>/<Y-Size>"
  126.      You can specify "*" if you don't want to change the previous
  127.      value (this is also possible in ZIPWIN and LIMIT), e.g.
  128.      WIN=0/0/*/* would simply move the window to the left-top of the
  129.      screen.
  130.  
  131. ZIPWIN/K
  132.      Same as in WIN. But you will only see the result if you zip the
  133.      window.
  134.  
  135. LIMIT/K
  136.      This option must be oft the form :
  137.      "LIMIT=<min. X-Size>/<max. Y-Size>/<min. X-Size>/<max. X-Size>"
  138.      Use -1 as value if don't want any restrictions, e.g.
  139.      with LIMIT=*/*/-1/-1 you can make the window as big as you like.
  140.  
  141. WTITLE/K
  142.      Set the window title to any text you like.
  143.      NOTE: The memory for this title will never be freed,
  144.            although this is very little you should know about this !!!
  145.  
  146. STITLE/K
  147.      Set the screen title of the window to any text you like.
  148.      You can only see the screentitle if the window is active.
  149.      NOTE: The memory for this title will never be freed,
  150.            although this is very little you should know about this !!!
  151.  
  152.  
  153. USEFULL EXAMPLES
  154. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  155. 1.) Have you ever opened thousands of drawers on your Workbench and
  156.     would like to close all those windows ???
  157.     SetWin * WBWIN CLOSE
  158. 2.) Do you open your shell with a command like
  159.     NewShell "CON:0/11/639/245/MyShell" FROM S:Shell-Startup
  160.     but you missed the possibility to set the zipped size of the window ???
  161.     Add a line to your Shell-Startup :
  162.     SetWin NOW ZIPWIN=559/189/80/50
  163. 3.) You would like to know all windows on a screen:
  164.     SetWin * VERBOSE ALL
  165.  
  166.  
  167.  
  168. If you have comments, suggestions, criticism, bug reports etc.
  169. send mail to
  170.  
  171.                 Frank Würkner
  172.                 Georgenschwaigstr. 22
  173.                 D-80807 München
  174.                 Germany
  175.  
  176.                 or
  177.  
  178.                 E-Mail: wuerkner@informatik.tu-muenchen.de
  179.